home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / droptrk3.zip / DROPTRK3.DOC next >
Text File  |  1991-11-29  |  7KB  |  161 lines
  1. DROPTRK3.EXE (c) 1991 by Richard Pate, 2421 E. 21, Odessa, Texas  79761
  2. -----------------------------------------------------------------------
  3. Release 0.03  BETA copy
  4.  
  5. Statement of Warranty and Liability:  NONE!
  6.  
  7. This program was written in Turbo Pascal 5.5.  It was written for use with
  8. your WILDCAT! ACTIVITY.nnn.  It will read the activity log searching for
  9. those who dropped carrier, and create a USERxxx.BBS file for each of them.
  10.  
  11. I use it in a daily event.  If a USERxxx.BBS already exists from yesterday,
  12. the program deletes that file and writes a new one.  It will list the times
  13. and dates each user dropped the carrier in the file it creates.
  14.  
  15. I use a utility to keep only the last 7 days of my activity.log, so this
  16. program will list dropped carriers for the last 7 days.  As you know, the
  17. USERxxx.BBS is erased by WILDCAT! after it is read by the appropriate user.
  18.  
  19. This program will continue writeing a file to that user each day until he/she
  20. no longer has any dropped carriers in the activity log ( the last 7 days in
  21. the case of my bbs ).
  22.  
  23. USING THE PROGRAM:
  24.  
  25. The program is very easy to use, as long as you follow a few rules.
  26. DropTrk3.EXE should be in the same directory as your ACTIVITY.LOG.
  27.  
  28. You must create a simple text file named DropTrk3.CFG with any ASCII text
  29. editor.  The CFG file contains the following lines:
  30.  
  31. Richard Pate             ; Name of sysop
  32. KwikSoft Solutions BBS   ; Name of BBS
  33. C:\WC30\DISP             ; Path to your display files
  34. C:\WC30\ACTIVITY.001     ; Path and FILENAME to your activity log
  35. C:\WC30\DATA             ; Path to your ALLUSERS.xxx file
  36.  
  37.  
  38. I have not got WC3 running yet, so this program has not been fine tuned.
  39. I THINK that you will need a different Config file in each node directory,
  40. setting the path to the different activity files.  I have not programmed in
  41. file locking, so if used on a multi-node system, it will be up to you to
  42. assure that maintenance for each node is run at different times.
  43.  
  44. WC3.x does not put the user number in the activity.xxx as WC2.x did, so this
  45. version of DropTrk3 must also open and read your ALLUSERS data files.  For
  46. that reason, it is a little slower than release 0.2.
  47.  
  48.  
  49. NOTE!
  50. =====
  51. If a new user drops carrier before he/she is given a user number, the
  52. program will NOT create a USERxxx.BBS for the user, since there is no
  53. user number.
  54.  
  55. The program has been modified to work with Version 3.x of Wildcat!  Beta
  56. release 0.02 would only work with version 2.x.
  57.  
  58. The following is an actual USERxxx.BBS created by DROPTRK3.EXE:
  59.               ------------------------------------------------
  60.  
  61.   THIS MESSAGE WAS CREATED AUTOMATICALLY FROM THE WILDCAT! BBS ACTIVITY.LOG
  62.      DropTrk3.EXE (c) 1991 BY RICHARD PATE, 2421 E. 21, ODESSA, TX  79761
  63.      U R On-Line with KwikSoft Solutions BBS.  Your sysop is Richard Pate.
  64. ══════════════════════════════════════════════════════════════════════════════
  65. TERESA,
  66.   In the following list you will find a record of your recent dropped carriers.
  67. If the board is hanging, please leave a comment to the sysop advising what you
  68. were doing when it hung, so that I can try to get it fixed.
  69.   If you are having hardware problems, please try to get it fixed.  If call-
  70. waiting is the problem, contact your phone service and see if it is possible
  71. to disable call-waiting temporarily while you are on line.  Thanks.
  72.  
  73. Dropped carrier at   21:49  on  Sun, 03-17-91
  74.  
  75.               -------------------------------------------------
  76. If you prefer to replace this message with your own,  simply put an ascii text
  77. file, with the name DropTrk3.MSG, containing your message in the same directory
  78. as DropTrk3.EXE.  If the program finds that file there, it will replace the
  79. "canned" message above with the message contained in DropTrk3.MSG.  The message
  80. will be inserted between the user's first name and the "Dropped carrier" list.
  81.  
  82. There is a control L and a control C imbedded at the beginning of the USERxxx
  83. file, so that it will clear the screen and force the user to wait until it has
  84. finished displaying before going on.
  85.  
  86. I run the program in my nightly maintenance event.  Below is a copy of my
  87. MIDNIGHT.BAT event file.
  88.  
  89.               -------------------------------------------------
  90.  
  91. COPY datafile\*.DAT e:\BACKUP\*.*
  92. COPY datafile\*.DIA e:\BACKUP\*.*
  93. COPY datafile\*.IX  e:\BACKUP\*.*
  94. DIR c:\BACKUP\*.* > e:\bACKUP\BACKUP.DAT
  95. copy c:\wildcat\activity.log   e:\backup\activity.txt
  96.  
  97. Sizemon
  98. Callers      : Appends today's callers to the weeks callers
  99.  
  100. cd\wildcat\livecat\fish
  101. del fishdat.*
  102. fishmant
  103. fishtext c:\wildcat\bull\bull13.bbs c:\wildcat\bull\bull13.scr
  104.  
  105. cd \wildcat\livecat\tw
  106. twmaint /B /L
  107.  
  108. cd\wildcat
  109. DropTrk3                            : Write USERxxx.BBS files
  110. doortrak c:\wildcat\bull\bull15     : Write BBS door usage chart bulletin
  111. timetrak c:\wildcat\bull\bull11     : Write BBS time usage chart bulletin
  112. ptcltrak c:\wildcat\bull\bull12     : Write BBS protocol usage chart bulletin
  113. trimwcal  7                         : Trim the activity log to 7 days
  114. cat
  115.               -------------------------------------------------
  116.  
  117. The program allocates memory to keep track of the data needed to track the
  118. carrier droppers, so it may be possible to run out of memory if your activity
  119. log is very long.  As I said, my activity log is only 7 days long, and I only
  120. have about 20-35 callers a day.  If you get a Runtime Error 203, there is
  121. not enough memory to run the program.  Each record requires 40 bytes of ram,
  122. so unless you have a LOT of carrier droppers in your activity log, there
  123. shouldn't be a problem.
  124.  
  125. If you have any suggestions for improving the program, or any gripes about the
  126. program, please don't hesitate to contact me at the above address, or leave me
  127. a comment on KwikSoft Solutions BBS at 915-367-1707  (300/1200/2400,8,N,1).
  128.  
  129. If you feel that this program is of value, a donation of whatever you think it
  130. is worth would not be turned down either...
  131.  
  132. Richard Pate
  133. Sysop, KwikSoft Solutions BBS
  134. 2421 E. 21
  135. Odessa, Texas   79761
  136.  
  137.  
  138. Voice (915) 367-1865
  139.  
  140. OTHER KwikSoft WILDCAT SYSOP UTILITIES:
  141.  
  142. DoorTrak          ; Makes chart of door usage
  143. TimeTrak          ; Makes chart of time usage
  144. PTCLTrak          ; Makes chart of UL/DL Protocol usage
  145. TrimWCAL          ; Trims Wildcat activity log to specified # of days
  146.  
  147. FIXES:
  148.  
  149. 03-19-91
  150. Fixed program so that the "\" is not necessary on the end of the path line
  151. in the config file.
  152.  
  153. 10-20-91
  154. Made modifications so that the full path and filename of the activity file
  155. is passed to the program from the configuration file.
  156.  
  157. 10-25-91
  158. Modified program to open and read ALLUSERS data and index files so it can get
  159. the user number.
  160.  
  161.